home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / docs / ascii / mint / mintnet / mintnet.faq
Encoding:
Text File  |  1995-01-29  |  6.9 KB  |  183 lines
  1.  
  2. MintNet FAQ v 1.0
  3.  
  4. November 24 1994
  5.  
  6. Written by Christer Gustavsson
  7.  
  8. Why this FAQ?
  9.  
  10. MintNet is a package that offers networking capabilities to
  11. the Atari ST range of computers. The package makes it possible to
  12. connect your computer over a SLIP, PPP or PLIP line to other
  13. computers. This is necessary to use it as a World Wide Web client,
  14. use local ftp, etc. Setting up MintNet has showed not to be a
  15. trivial quest and there are a lot of fallacies and pitfalls. This
  16. faq is meant to help the persons that want to use MintNet but for
  17. some reason have problems getting started. This faq has been
  18. written to describe how to set up MintNet 0.5 pl 5. Because of
  19. this there are some details that won't work with earlier versions
  20. of MintNet described. The slattach command hasn't, for instance,
  21. in earlier versions of MintNet the option -l.
  22.  
  23. What is needed and where to get it.
  24.  
  25. First of all Mint version 1.08 h8 or higher is needed.
  26. Previous versions lack of a few calls that are necessary for
  27. networking. Mint 1.12 is available to the public in a binary
  28. version and I recommend to use this version or later versions.
  29. Secondly you will need the MintNet package. The latest version
  30. today is 0.5 pl6. This FAQ is written with MintNet 0.5 pl5 in mind
  31. and some of this info isn't correct for versions before 0.5 pl5.
  32. You will also need a shell and if you choose sh this will work
  33. with the files distributed with MintNet.
  34. If all you want to do is to connect to another network this is
  35. all you need. If you want to, for instance, run your machine as a
  36. ftp server you will need a few daemon programs. For now I will
  37. only describe how to get clients to run on your machine.
  38. I also recommend that you get the following client programs in
  39. order to have something to test with. Udpprobe and ping are
  40. programs to test if other host respond to the packets you send.
  41. With telnet you can log on other machines. With ftp and ncftp you
  42. can fetch files off ftp sites. Lynx is a WWW text browser.
  43. The latest version of MiNT can be found at
  44. atari.archive.umich.edu in the Mint folder, sh in the Mint/Shells
  45. folder, the MintNet package, telnet, udpprobe, ping and ncftp in
  46. the Mint/Network/MintNet folder and lynx in the Mint/Network/Www
  47. folder.
  48.  
  49. Where to put the programs and files.
  50.  
  51. MiNT:
  52. First put mint.prg in your auto folder of your boot disk. You
  53. also need a file mint.cnf that should be in the root folder, mint
  54. folder or multitos folder of the boot disk.
  55.  
  56. MintNet:
  57. Put sockdev.xdd in the same folder as mint.cnf. You also need
  58. protocol drivers. If you intend to use SLIP/PPP then put slip.xif
  59. in the same folder as sockdev.xdd.
  60. Make a folder called mintnet on your boot disk. In this you
  61. shold have the following files:
  62. etc\:
  63. netstat, ifconfig, iflink, route, slattach, host.conf (0.5 pl6
  64. and higher), hostname, hosts, networks, protocols, rc.net,
  65. resolv.conf and services.
  66. usr\ucb\:
  67. Here you can put your client software ie, ping, udpprobe,
  68. telnet, lynx, ncftp etc.
  69.  
  70. Sh:
  71. Make a folder called bin in your mintnet folder. Put sh there.
  72.  
  73. How to set things up.
  74.  
  75. You should have the following in your mint.cnf:
  76.  
  77. #Set the path so that your programs can be found when you run
  78. a shell
  79. setenv PATH u:\bin,u:\etc,u:\usr\ucb
  80.  
  81. #Make symbolic links to your unified file system
  82. sln c:\mintnet\bin u:\bin
  83. sln c:\mintnet\etc u:\etc
  84. sln c:\mintnet\usr u:\usr
  85.  
  86. cd u:
  87.  
  88. #Setup the loopback interface
  89. exec \bin\sh \etc\rc.net
  90.  
  91. #Note that since the working directory is changed to u: no
  92. programs after mint.prg in the auto folder is run. Mint should
  93. therefore be the last program in your auto folder.
  94.  
  95. You also need to have some info about the site you want to
  96. connect to. You should know which address your own machine will
  97. have and which address the machine that you are going to connect
  98. to has. It is also a good idea to have the address to a name
  99. server. If the name server is on the other side of the connection
  100. the addresses must be ip numbers.
  101.  
  102. To make setting up a little easier a list of the setup files
  103. and what's supposed to be in them follows.
  104.  
  105. /etc/host.conf (MintNet 0.5 pl6 and later):
  106. Contains info on how the namesearching should be done.
  107.  
  108. /etc/hostname:
  109. This file contains the name of your machine. If your machine
  110. has the address dumdum.idioti.iq /etc/host should contain the
  111. line:
  112. dumdum.idioti.iq
  113.  
  114. /etc/hosts:
  115. This file contains a list of hosts with matching ip numbers
  116. and shortcuts. If you want to add the machine with the address
  117. dumdum.idioti.iq and ip number 123.45.67.89 and want this host to
  118. have the shortcut dd you simply write:
  119. dumdum.idioti.iq    123.45.67.89    dd
  120. Each line has the form <host> <ip number> <shortcut>. There
  121. should be no more than one entry on the same line.
  122.  
  123. /etc/networks:
  124. This contains a list of the networks that can be reached.
  125.  
  126. /etc/protocols:
  127. This file contains a list of protocols that the machine can
  128. handle. It is usually not necessary to edit this file.
  129.  
  130. /etc/rc.net
  131. This file starts the available network daemons and the
  132. loopback interface. The loopback interface should be started with:
  133. /etc/ifconfig lo0 addr 127.0.0.1 up
  134. /etc/route add 127.0.0.0 lo0
  135. These lines are the only ones that are needed if you only
  136. intend to use MintNet for ie www and ftp.
  137.  
  138. /etc/resolv.conf:
  139. This file contains entries regarding the domain and
  140. nameserver. If your domain is idioti.iq you should have the line:
  141. domain idioti.iq
  142. in this file, and if your nameserver has the ip number
  143. 123.45.67.89 you should have the line:
  144. nameserver 123.45.67.89
  145. too.
  146.  
  147. /etc/services:
  148. Contains a list of services that is offered by the machine.
  149. This file should usually not be changed.
  150.  
  151. How to make the connection.
  152.  
  153. To make a connection to a remote host you can use an ordinary
  154. communication program. When connected you have to set the line to
  155. slip mode. Your local operator can tell you how to do this. When
  156. you have made the physical connection you must attach a slip/ppp
  157. channel to it. This can be done with the slattach command. If you
  158. want to attach the modem1 port, your remote host is called
  159. bjorne.idioti.iq and your local machine is called dumdum.idioti.iq
  160. you can write:
  161. /etc/slattach -l dumdum.idioti.iq -r bjorne.idioti.iq -t
  162. /dev/modem1
  163. to achieve the connection. Note that you have to use ip
  164. numbers if the nameserver you intend to use is on the other side
  165. of the connection! The -l flag stands for local host, -r flag
  166. remote host and -t tty. After this you can test the connection
  167. with ping or udpprobe. The command:
  168. ping bjorne.idioti.iq
  169. tests if your remote host responds to the packets you send.
  170. The command:
  171. udpprobe bjorne.idioti.iq echo "Yeah!"
  172. should echo Yeah! on your terminal. If this works other stuff,
  173. like www browsers and ftp clients should work too.
  174.  
  175. Where to report errors in this FAQ.
  176.  
  177. If you find something that isn't that clear or not correct in
  178. this document please report directly to me and I will correct it.
  179. My email address is: d2cg@dtek.chalmers.se.
  180.  
  181.  
  182.  
  183.